package com.smart.community.work.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.smart.community.work.entity.SecurityEvent;
import com.smart.community.work.vo.SecurityEventVO;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.time.LocalDate;
import java.util.List;
import java.util.Map;

/**
 * 安保事件Mapper接口
 * 
 * 严格按照《Java后端SpringBoot代码开发规范_重构版.md》Mapper规范实现：
 * - 继承BaseMapper：获得基础CRUD方法
 * - 方法命名：使用动词+名词形式，语义明确
 * - 参数注解：使用@Param注解标注参数
 * - 返回类型：使用具体的返回类型，避免使用Object
 * - 完整注释：所有方法都有完整的JavaDoc注释
 * - 数据访问封装：Mapper层负责所有数据库操作
 * - SQL优化：编写高效的SQL语句
 * - 参数映射：正确使用MyBatis参数映射
 * - 结果映射：正确使用MyBatis结果映射
 * - 数据访问封装：Mapper层负责所有数据库操作
 * - SQL优化：编写高效的SQL语句
 * - 参数映射：正确使用MyBatis参数映射
 * - 结果映射：正确使用MyBatis结果映射
 * 
 * @author Wu.Liang
 * @since 2025-01-30
 * @version 1.0.0
 */
@Mapper
public interface SecurityEventMapper extends BaseMapper<SecurityEvent> {

    /**
     * 分页查询安保事件
     * 
     * @param page 分页参数
     * @param eventType 事件类型（可选）
     * @param severity 严重程度（可选）
     * @param reporterId 报告人ID（可选）
     * @param handlerId 处理人ID（可选）
     * @param status 状态（可选）
     * @param startDate 开始日期（可选）
     * @param endDate 结束日期（可选）
     * @param propertyCompanyId 物业公司ID（可选）
     * @return 分页结果
     */
    IPage<SecurityEventVO> selectSecurityEventPage(Page<SecurityEventVO> page,
                                                   @Param("eventType") String eventType,
                                                   @Param("severity") Integer severity,
                                                   @Param("reporterId") Long reporterId,
                                                   @Param("handlerId") Long handlerId,
                                                   @Param("status") Integer status,
                                                   @Param("startDate") LocalDate startDate,
                                                   @Param("endDate") LocalDate endDate,
                                                   @Param("propertyCompanyId") Long propertyCompanyId);

    /**
     * 根据ID查询安保事件详情
     * 
     * @param id 事件ID
     * @return 事件详情
     */
    SecurityEventVO selectSecurityEventById(@Param("id") Long id);

    /**
     * 根据报告人ID查询事件列表
     * 
     * @param reporterId 报告人ID
     * @param status 状态（可选）
     * @return 事件列表
     */
    List<SecurityEvent> selectByReporterId(@Param("reporterId") Long reporterId, @Param("status") Integer status);

    /**
     * 根据处理人ID查询事件列表
     * 
     * @param handlerId 处理人ID
     * @param status 状态（可选）
     * @return 事件列表
     */
    List<SecurityEvent> selectByHandlerId(@Param("handlerId") Long handlerId, @Param("status") Integer status);

    /**
     * 查询待处理事件
     * 
     * @param handlerId 处理人ID（可选）
     * @return 待处理事件列表
     */
    List<SecurityEvent> selectPendingEvents(@Param("handlerId") Long handlerId);

    /**
     * 查询紧急事件
     * 
     * @param startDate 开始日期（可选）
     * @param endDate 结束日期（可选）
     * @return 紧急事件列表
     */
    List<SecurityEvent> selectUrgentEvents(@Param("startDate") LocalDate startDate, @Param("endDate") LocalDate endDate);

    /**
     * 查询事件统计信息
     * 
     * @param startDate 开始日期
     * @param endDate 结束日期
     * @return 事件统计信息
     */
    Map<String, Object> selectEventStatistics(@Param("startDate") LocalDate startDate, @Param("endDate") LocalDate endDate);

    /**
     * 查询事件类型统计
     * 
     * @param startDate 开始日期
     * @param endDate 结束日期
     * @return 事件类型统计
     */
    List<Map<String, Object>> selectEventTypeStatistics(@Param("startDate") LocalDate startDate, @Param("endDate") LocalDate endDate);

    /**
     * 查询事件严重程度统计
     * 
     * @param startDate 开始日期
     * @param endDate 结束日期
     * @return 事件严重程度统计
     */
    List<Map<String, Object>> selectEventSeverityStatistics(@Param("startDate") LocalDate startDate, @Param("endDate") LocalDate endDate);

    /**
     * 查询事件状态统计
     * 
     * @param startDate 开始日期
     * @param endDate 结束日期
     * @return 事件状态统计
     */
    List<Map<String, Object>> selectEventStatusStatistics(@Param("startDate") LocalDate startDate, @Param("endDate") LocalDate endDate);

    /**
     * 查询处理人工作统计
     * 
     * @param handlerId 处理人ID
     * @param startDate 开始日期
     * @param endDate 结束日期
     * @return 处理人工作统计
     */
    Map<String, Object> selectHandlerWorkStatistics(@Param("handlerId") Long handlerId,
                                                   @Param("startDate") LocalDate startDate,
                                                   @Param("endDate") LocalDate endDate);

    /**
     * 更新事件状态
     * 
     * @param id 事件ID
     * @param status 状态
     * @param updateBy 更新人ID
     * @return 更新数量
     */
    Integer updateStatus(@Param("id") Long id, @Param("status") Integer status, @Param("updateBy") Long updateBy);

    /**
     * 分配事件处理人
     * 
     * @param id 事件ID
     * @param handlerId 处理人ID
     * @param updateBy 更新人ID
     * @return 更新数量
     */
    Integer assignHandler(@Param("id") Long id, @Param("handlerId") Long handlerId, @Param("updateBy") Long updateBy);

    /**
     * 处理事件
     * 
     * @param id 事件ID
     * @param status 状态
     * @param handleTime 处理时间
     * @param handleResult 处理结果
     * @param updateBy 更新人ID
     * @return 更新数量
     */
    Integer handleEvent(@Param("id") Long id,
                       @Param("status") Integer status,
                       @Param("handleTime") java.time.LocalDateTime handleTime,
                       @Param("handleResult") String handleResult,
                       @Param("updateBy") Long updateBy);

    /**
     * 批量更新事件状态
     * 
     * @param ids 事件ID列表
     * @param status 状态
     * @param updateBy 更新人ID
     * @return 更新数量
     */
    Integer batchUpdateStatus(@Param("ids") List<Long> ids, @Param("status") Integer status, @Param("updateBy") Long updateBy);

    /**
     * 删除事件
     * 
     * @param id 事件ID
     * @param updateBy 更新人ID
     * @return 删除数量
     */
    Integer deleteById(@Param("id") Long id, @Param("updateBy") Long updateBy);

    /**
     * 批量删除事件
     * 
     * @param ids 事件ID列表
     * @param updateBy 更新人ID
     * @return 删除数量
     */
    Integer batchDelete(@Param("ids") List<Long> ids, @Param("updateBy") Long updateBy);
}
